# DESCRIPTION
Watches for changes to files in the current directory and its subdirectories,
-and automatically syncs them to other remotes.
+and automatically syncs them to other remotes. This includes adding new
+files. New files published to remotes by others are also automatically
+downloaded.
+
+By default, all new files in the directory will be added to the repository.
+(Including dotfiles.) To block some files from being added, use
+`.gitignore` files.
+
+By default, all files that are added are added to the annex, the same
+as when you run `git annex add`. If you configure annex.largefiles,
+files that it does not match will instead be added with `git add`.
# OPTIONS
background, you no longer need to manually run git commands when
manipulating your files.
-By default, all files in the directory will be added to the repository.
+By default, all new files in the directory will be added to the repository.
(Including dotfiles.) To block some files from being added, use
`.gitignore` files.